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Editor 9 s XfrioiAsfetis 
By Jil DtStiftoo 



Por those) that have asked; yes, 
Ron Anderson's series, "Beginners 
Corner" , was superseded in April 
by Ron's operating system over 
view, and in Hay by his two rev* 
iews. This month the series has 
been replaced by Peter Stark's 
letter of clarification and addi- 
tion-to Ron's operating system 
overview article. However, don't 
get antsy. "Beginner's Corner" 
will be back next month. 

This month marks the introduc- 
tion of a series, "Tech Corner", 
by J. Scott Hasten. He is a pro- 
fessional programmer with a gift 
that allows him to share what he 
knows in an interesting manner. 
Welcome aboard Scott, we are 
pleased to have you, and are look- 
ing forward your future articles. 

Again, there is no room for a 
"Letters to the Editor" column. 
However, lets slid a couple in 
right here: 

HOW 'BOOT MORE 
I'd like to see more for the 

CoCo-3. 



Ttl±; 



Editor's thoughts 
Letters to the editor! 

Ran doss Ruaiber Uses 

Bob van der Poel shows us 
« fast shuffle in C. 

Thai Technical Corns 

J. Scott Kasten begins his 
new series with graphic 
thoughts in C. 

Rush Calej, LIVE! 
Beware! They may be 
watching. . . 



lO 



Repl 



X to Rex , 
& OS-9 . • - 
Peter Stark gives a multi- 
level insight into SK*DOS 



SK*DOS 
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Ernest Dotson, Jr 
Charleston, WV 

Keep in mind, all the 'C ac- 
tion will work on the CoCo under 
OS- 9. Also, we haven't had any 
09BASIC as yet, but I'm sure it 
won't be long before we do. 



I THOUGHT A MONITOR WAS... 
I'd like to read about other 
68XXX operating systems. What is 
REX/Monk anyway? What about Minix? 

James Truesdale 
Perguson, MO 

Our April issue had a good ove- 
rview of REX, however Monk was 
lightly passed over. Monk is a 
monitor used with REX. Yes, moni- 
tor in computer terms can mean 
software too. Monk is an example 
of the software definition. As 
software, a monitor is a short M/L 
program. They are in ROM, automat- 
ically activated upon startup. 
Though a monitor may have several 
routines of its own, its principal 
duty is to automatically load and 
execute another program, like an 
v operating system; in the case of 
Monk, REX-DOS. He have a review of 
the UNIX look a like, Minix coming 
soon . 



COMM, HOW-TO? 
One thing I'd like to see is 
information about the selection, 
installation and use of a modem in 
bulletin board accessing. 

William Tobin 
Jacksonville, PL 

Call Oil Shaduck, the propri- 
etor of Granite Computer Systems, 
one of our advertiser. He is as 
deep into modems as anyone. (Maybe 
there is a reader that would like 
to write an article addressing the 
question?) 



MULTIPLE OPERATING SYSTEMS: 
Write about multiple operating 
systems on one machine. The host 
should be UNIX or OS-9 and run 
MS-DOS as a guest. In fact, we 
should be able to run a different 
OS in each window. 

Wood Elis 
Arlington, VA 

Well Wood, that's a tall 

request. IBM (OS-2) and most of 



the other leading companies have 
been trying to do the same thing. 
On our level, give Ed Gresick of 
the delmar company, one of our 
advertisers, a call. He and Perip- 
heral Technology are working on 
the problem. They have a rounda- 
bout solution for today, and ex- 
pect a direct solution in the fu- 
ture. 



WHAT 'A BOUT BATTERY POWER Edi- 
tor : 

I'd like articles on a battery 
powered ram disk, and a print spo- 
oler. I'd also like some new BBS 
phone numbers. 

Bill Hughs 
Valley Palls, KS 

OK hardware hackers, can you 
write a generic battery powered 
memory article? I guess a generic 
spooler would be asking too much, 
but if you can't do either, send 
in a BBS number. 
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More Random Number 
Uses 

i 

By Bob Tin dtr Po«l 



Last month we discussed a 
novel use for a random number gen- 
erator (in justifying text). This 
month we* 11 be a bit more conven- 
tional and develop a general pur- 
pose card dealing function. 

When creating a card dealing 
routine a programmer's first im- 
pulse could be to create a deck 
and then to shuffle it — just like 
a human dealer might. Unfortuna- 
tely, this is fairly complex and 
time consuming. A much simpler 
method is to represent the cards 
in an array and deal them out at 
random. All that is needed to rep- 
resent 52 cards is a 52 byte array 
with each element representing a 
unique card. In this case we will 
use: 

char deck[53]; 

Note that we have allocated 53 
slots for the deck. The reason for 



this is we don't want to bother 
with card '0'. This way the num- 
bers of the cards can be 1 to 52. 
This can match slots 1 to 52. Slot 
0 is unused. The cards in the 
deck are labeled 1 to 52: Card 1 
is the Ace of Hearts, card 2 is 
the Ace of Diamonds . . . card 52 
is the King of Clubs. To convert 
card numbers to conventional nota- 
tion we can use: 

suits (cardnumber-l)/13; 
values cardnumber-(13*suit) ; 

To create the deck it is a sim- 
ple matter to fill in the array 
with the card 
numbers: 

for(c»l;c<53;c++) deck[c]=c; 

All that is left is an effi- 
cient method to select a card and 
to keep track of what cards are 
left in the deck. The simplest 
method is to have a counter repre- 
senting the number of cards left 
in the deck. This is initialized 
to 52 when the deck is created: 

cardleft=52; 



*** New For OS-9/68000 *** 

Our famous VED text editor is now available for computers running the OS-9/68000 
operating system. It uses TERMCAP functions to make it compatible with most 
terminals. Nearly all of VED's internal settings (lacro definitions, key-bindings, 
editing nodes, etc.) can be nodified fron an initialization file. VED's editing 
node options include insert/overstrike nodes, automatic indenting and numbering, 
wordwrap on/off, etc. Standard functions like search, find/replace, blocknove/ 
copy/delete, word and line delete are completely supported with countless variants 
and options. A conplete set of "undo" functions make it easy to correct mistakes. 
VED also has a built-in text fonatter; included in the command set are margin 
settings, headers and footers, justification nodes, and enbedded connands for 
various printer fonts (italic, underline, etc). An interactive preview node makes 
it easy to see what the final document will look like when printed. User 
extendable help screens speed things up when you just need a refresher, rather than 
using our detailed, indexed 68 page reference guide. 

To order VED please send us your check or money order (sorry, no credit cards) for 
$39.95 plus $3.00 S/H. 

Bob van der Poei Software 
P0 Box 57 P0 Box 355 

Wynndel, B.C. or Porthill, ID 
Canada VOB 2N0 USA 83853-0355 
Telephone 604-866-5772 
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Now, to select a card we pick a 
random number between 1 and 'card- 
left* and select that card: 

i 

n=(rand() % cardleft) + 1; 
c=deck[n); 

Here we have used a convention- 
al rand() function which returns a 
random integer. Depending on the 
rand() or rnd() functions you have 
for your compiler you might have 
to fiddle with this. 

Now, (the neat part) we move 
the last card in the deck to the 
slot we just selected. If we don't 
do this we'd have to set up flags 
to represent already picked cards, 
etc. This way we just shorten the 
array: 

deck[n]-deck[cardlef t — ]; 

The following code contains the 
complete deal and shuffle rout- 
ines. ShuffleO is automatically 
called whenever the deck is emp- 
tied, you should call it whenever 
you start a new hand. Note that it 
seeds the random number generator 
with the system time the first 
time it is called — you may need to 
change this for your compiler. 



Getcard() returns the card number 
and sets the variables passed to 
the card value and suit. To call 
it use something like: 

iat card, suit; 
char ••uiUMjilH 

Cluba . 

Diaioadi , 
>irts\ 

•SptdM* 

/ ! 



|«tcird(&c»rd, iiuit); . m 
priBtf(*C*rd it the ts of Xd\o\ 
luitBiitf (iuit J.ctrdJ; 

Note we have passed pointers to 
'suit' and 'card'. This is because 
it is not possible for a C func- 
tion to return more than one val- 
ue. The 'card' values returned 
will be in the range 1 to 13; the 
'suit* values will be 0 to 3--you 
can assign "Clubs", etc. in any 
manner you .wish to these values. 
Of course, the printf ( ) in the 
above example needs some work — - 
right now the card values are pri- 
nted as "1", "2" . . . "13". Can 
you fix it up so that we get "Ace" 
. . . "King"? 



Tbii root i at creates a deck of cards. The ten 
shuffle it ictoill; a lisooier since the cards are 
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sot held in a ihuffled stats. Deal() picks a raodoi 
card from the regaining cards in the deck. The deck 
is ao array o-f 52 ouiberi (1..S2) rtpressntiag the 
different cards. 

lioclude <oi9.h> 

/• these vara are ahared bj ahuffle() and 
teteardO •/ 

static char deck(53); /« the deck */ 
statie direet int cardltft=0; /"cards left 
to deck"/ 

jhaffl.O 

register int c; 

int t; 

ststic firit=0; 

it met register regs; 

char tiieboflM; 

if (!first){ 

regs.rg.i : tiiebaf ; /' buffer for ttM 



packet 



osMI TIII,lrtitj; , . , A 

For(c=ff;c<s;c**I t* s ti|tbuf [e]; /* get 
tiM aombtr '/ 
erind(t)i /* seed rnd gen •/ 
firsts; 



for(e=l;e<53;c**) deek(c]=e; 
earditft=52; 



poll a card froa the deck 



int \t*rt; /» fslue (1 - .13) of card (king=13) •/ 
int t suit; /• luit of the card selected "/ 

register int c; 

int n; 

if(!cardleft) shoffle(); /* just in case the? 

are all gone '/ 

■=(rand()Zeardleft)+l; /* get raadpf card 
nuiber '/ 

e=deck(n); /* the talus of the 

eard "/ 

deek(n]=deck[cardUft— ]; /• delete this card 
froathe deck */ 

•suit=(e;l)/13: 
*csrd=e-(ll * Unit); 

/■ 

suabei 



re torn c| 



/* return Jje card 



Z have used the above code very 
successfully in a number of card 
game simulations. It could be exp- 
anded for multiple decks just by 
changing the array size. 

Next month will be a bit more 
serious (hnrnn, try telling some of 
my friends that cards are frivo- 
lous!). As always, if you have 
comments or suggestions on these 
columns drop me some mail at PO 
Box 355, Porthill, ID, 83853. 



gstesrd(card, suit) 



PT68K2/4 Programs for REXDOS & SK*DOS 



EDDI 


A screen editor and formatter 


$50.00 


SPELLB 


A 160,000-word spelling checker 


$50.00 


ASMK 


A native code assembler 


$25.00 


SUBCAT 


A sub-directory manager 


$25.00 


KRACKER 


A disassembler program 


$25.00 


NAMES 


A name and address manager 


$25.00 



Include operating system, disk format, terminal type and telephone 
number with order. Personal checks accepted. No charge cards. 



PALM BEACH SOFTWARE 
Route 1 Box 119H 
Oxford, FL 32684 
904/748-5074 
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Corner 
By J. Scott Kasten 



Welcome to a new column! X hope 
to cover a number of topics of 
interest to the general program- 
ming public. Although we will talk 
a little bit about programming 
technique, the concentration will 
be on the technical information 
that one needs to program effecti- 
vely. 

The source code * listings will 
be generated under OS9/68000 with 
C and assembly languages. The code 
will be designed such that readers 
with other systems can adapt it 
rather easily. 

The first topic to be covered 
will be COMPUTER GRAPHICS, one of 
my favorite subjects. He will be 
spending several columns on this 
so let us lay some ground rules. 

When one does graphics program- 
ming in C, a graphics library is 
normally used. Discussing graphics 
in a column like this is a problem 
because there are so many differ- 
ent graphics adapters and graphics 
libraries in use. Any source code 
listing given is pure gibberish to 
someone using a different system. 
In addition, some graphics are 
done in assembly for performance 
reasons. However, using assembly 
in C can be tricky if you have 
never seen examples, fortunately, 
there is a simple solution. Let us 
start by building an ultra basic 
library of our own! 

There are some basic routines 
any library must have, so we will 
start with those. He must be able 
to activate the desired graphics 
mode, clear the screen, set 
points, and return to a text mode. 
Hith these few routines, we can 
accomplish quite a bit. 

These routines are quite simple 
to write using 0S9 on a Peripheral 
Technology system. It is as simple 
as making a system call to the 
screen driver. The system calls 
are best accomplished with assem- 
bly; this is where the C-assembly 
hybrid comes in. 

The design of Microware's C 
compiler facilitates the develop- 
ment of such a hybrid. The compil- 
er translates the C source code 



into 68000 assembly. It is fed to 
the system assembler and the link- 
er in turn. There are two ways to 
use assembly in your C programs. 
One is using the inline code op- 
tion, the other is to use the ass- 
embler and link the code by hand. 
Either way it's done, there are 
certain rules to be followed. 

The first rule concerns the CPU 
registers. On entry to a proce- 
dure, the arguments will be placed 
in registers DO and Dl, any other 
arguments will be placed on the 
stack. Data types less than 32 
bits will be sign extended to the 
full 32 bit width of the register 
size, even when placed on the 
stack. The exception is the float 
data type. This will be converted 
to a double. If a double is the 
first argument passed, it will 
occupy both DO and Dl when passed. 
Any other args will be put on the 
stack. On return from a procedure, 
the return value will occupy DO, 
and perhaps Dl if it's a type dou- 
ble. All registers not used in 
parameter passing must be pre- 
served. There are some special 
registers that sort of belong to 
the programmer. These are regis- 
ters D4-7, and A2-4. The registers 
in this group are used when a 're- 
gister' declaration is used in the 
C source code. Such a declaration 
causes the data element to be han- 
dled in one of the above registers 
as much as possible. Note: These 
registers must still be restored 
at the end of the routine if used! 

The second rule, any procedure 
declaration done in assembly must 
be made a global symbol using the 
colon operator. 

The third rule, libraries 
should have a header file to de- 
clare the procedures contained as 
external . 

This is quite a mouthful to 
digest all at once. I never could 



Classified Ads 

- fifTIt - SS-50 eanipieat. SWT CPU card, alio 
Gtaii PIO 128 30 pin) IDC. Alen I. Cordon. RD 

/ uo mi in st / niiii, n / oos) 

153-8000. 

- Sill - PT68I-2 complete lyitei: lOHflt 
■otherbd w/lR RAH. 2 OR hird drive. 720K floppy, 
liber tooitor. St* DOS, RBASIC, IDDL, all lit em- 
ail, lore! Uied very little, $800 * shipping. 
Phil Krieg. 1122 1/2 Baylaod, Bouatoo TX 77009. 
713/861-0367 eve/«keods. 

Turn that old coiputer eauipieot into cash with 
a Mm claiiified ad. Sale adjt are $5 per 50 
character line. lasted adt are juat $2.50 per 50 
character line. 
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assimilate a large mish-mash of 
rules without working through them 
first. Nor do I expect you to ei- 
ther. Check them out to be sure 
you 'have them' and then lets 
start working with some real code. 
He will see how this all fits tog- 
ether. The first thing to do is to 
create the file 'GPX.C. This is 
the library source code file. 

Listing il for OPX.C 

/* 

loftia< tt tin m irttbici. 
fort! Crapfcici(tkira*4«); 

t, 

fm Cnpiiei: 1 Savi rip m stack. 

Mttt.t 4M2,*(i») * C*fj wot* (it) U trtftf fff. 

mm. i 41,42 • Sit tati ti St40it. 

tttt^.l 11,40 * Set iftrattM e»4i. 

mti.i MM, 1*1 • n ifi call. 

OS! USttStt 1 Itcall rtti. 

■mt.l (ii)*,4HI 

ft § UUu* 

Notice this routine is done 
entirely in assembly, yet it will 
be fed into the C compiler. As 
soon as the compiler sees the lasm 
statement, it starts sending the 



source code out to the assembler 
directly instead of translating it 
first. When the # end asm statement 
is encountered, the compiler 
starts processing the code as it 
did before. Also notice the colon 
after the procedure name; this is 
the directive that tells the link- 
er this symbol will be used out- 
side of this source code file. You 
must use it I 

This routine has exactly one 
calling argument - the graphics 
mode number. I felt a one byte 
value would be sufficient to hold 
the value. The data type in C that 
consists of one byte is type CHAR. 
When calling this routine, you 
would use an argument of this same 
type. The calling argument is ext- 
ended to 32 bits and placed in 00 
before entering this routine. 

The I$8etStt call to the driver 
needs 3 arguments. It needs a path 
number, an» operation code, and a 
mode argument. These should be 
placed in regs d0-d2 respectively 
so the driver can find them. The 
path is assumed to be StdOut (1), 
and the operation code is $80 - 
the value for SS_SetMode. This is 
a function provided by the Periph- 
eral Technology driver. The driver 
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SYSTEM IV 




; : Computer already serving : ; > 
• Customer* hert mfc \ 



. ErpaiidaKIc Mt^tfMil^^^ \ 



< Vcmtiic enough to tiac O^9/68000» : 
Po wtttfH ■< outperforms .titfieij ; ; j j : : 



:• t v. Optional Phi£iu Board for i i" ■ \ I 
i 4 r Will support Otter OpentiBg j : 



mi 



Terminal Systems 



Just call, FAX or drop us a line. We 
will respond promptly with complete 
pricing and specifications 

DELMAR 00 • serving its' customers since 1975. 

. . . from $999.00 Console Systems .... from $1,149.00 
Asaembled botrdi and kits ifiiltola 



delmar co 

Middletovn Shopping Center . PO Box 78 . Middletovn, DC 19709 
30&378.2S55 FAX 302-278. 2556 



OS9/68000 SOFTWARE 



; : ; ilWti omb** the mfo (8$ Utt\ ; ft <>p*c*fog 'iymk M \towpm\ GSM809 ; : :• 
QUICK ED • Screen Editor and Text Formatter $275.00 



A high quality documentation tool and program editor ideally raited to later printer uteri. Uses 
f unction tad cunor keyi oo 107 terminal configurable per user. Micro.jmniiet mixed proportional 
text Automatic table of contenti generation and userdefinable macroa and command*. Handles an 
unlimited number el fonts. Drive* any printer. Ideal for multiuser systems. Arailable on a 304ay 
try before.70u.bu7 basis. 

pp^HM^ $495,00 

; : : Flewlinl tM> tiiiee^tt^^ G jprogHma* tift options teotrd checking : : : : 

: '• • 'iff '■ frrnbol ****** ev error mimberr : Cbecki included intermodule Incttntaietttie*. definitiott tod : : 
: ; wags of Ttrlable^ tuuUui es, union* and arrays, 'iiideim tL0^:c*«e faB-tbroogW type 
: : : primf and scaaf format itring: iiittm^ iraspU^i^s: A must for all serious € 

: : : pr^flTOUnWflTty: : : : : :■: : : : : : : : : : : : : : : : : : : : : : ; : : : : : : : ::::::: : : : : : : : : ::::::: : : : : :::■::: :::::::■:;:: : :■: : :::::: : 

DISASWLOS9 . OS-9/68K DUaMembler 9250.00 

Thi* high-speed, threefass 66000 disassembler can ako bandle the 66010 and 6802a It in- 
tellipnty decodes module header* and produce* symbol information that tan be reputed^ edited 
and passed through the disassembler allowing iterative disaisemhfy. The rystem libraries are read to 
supply symbol*. 

:::lMF:dc«:**^^ 

::::we3I^el»Ted.' ceosiitent; sad exlremeiyiflei^^: It ha* t built«ia Glik* j*eproc**sbc end ha* com<: :•• 

! i ; : i^hMni : itfoty! let* MWI^i^M M 'mite: 'Ml $i iwtet; '■. 

■ ; j Ajsembty.lsiigutgf or ycampiU&m ate ensily constructed.^ j j j j ;j j j j jj j \ j j ; j j j j j j j ; j j ; ;.j j ; • j ; } j \ \ \ \ ; ; ; ; 

WINDOWS . C Source Code Windowinff Library $250.00 

This C source code library package supports multiple overlapping windows displayed on one 
character*baaed terminal screen. It rapports window headers and footers, and pop*up windows. 
Windows mi7 be moved* panned, written to while offecreen, etc 

: : : Designed to profile nwi^tate programs, i Profile ierTecHvely : «aplea \ traced : execihion : building • : • ■ 
\ \ \ teteAMvntoim : a»':it : |^e*v': It reads' sjr^bol uble modttlw ;to^ a fuA^^uDctioG *co61nrt i \ \ \ 
•; ■ \ id the; time sj^tdur^ The^ u^miy ^mw^ *t \']\ \ 

,:j:i»djws*es'w6 

PC9 . MS-DOS to OS-9 Windowing System $350.00 

PC9 allows an MS-DOS computer to be used as a terminal to multiple prooetaea on a remote 
OS- 9 system linked by a single serial cable. Bach OS- 9 process is displayed through a 
resizable, moveable window on the PC screen. Terminal emulation facilities support uMACS 
and other screen editors and provide a programmable PC keyboard. Access to PC disk drives 
it also avilable through the OS-9 unified I/O system, giving disk capability to ROM based 
OS- 9 systems. 

delmar co 

Middletown Shopping Center- PO Box 78- Middletown.DE 19709 
30237&25S5 FAX 302378-2556 



would also like the mode value in 
reg D2, not DO, so we must move 
it. 

Please note the use of the 
movem instructions at the begin- 
ning and end of the procedure. He 
must preserve the registers we 
borrow, remember?!! 

If you are using a different 
system, you will probably have to 
activate a graphics mode in a dif- 
ferent way. Just use the code spe- 
cified in the literature you got 
with the machine. BUT, please use 
the same procedure name as above! 
The whole point of this exercise 
is for everyone to have a similar 
set of graphics calls when we 
start to do some really serious 
stuff. 

Next time, we'll try to finish 
this library and learn some more 
about the Microware C compiler. If 
you're having some trouble digest- 
ing all this and have the OSK C 
manual, look in section 3-1. He'll 
talk more about this next time. 



(Questions and comments can be 
addressed to Mr. Kasten in care of 
The 68xxx Machines.) 



R/i_&s1t Caley, Live! 



This was to be the month I out- 
lined my perfect solution to the 
drug problem in America; but now, 
that will have to wait until next 
time. I'm finally to the boiling 
point concerning the Federal, 
State, and local Government moni- 
toring our lives. Now don't get me 



> ? 7o sher i -p-fat 
you do. " 



wrong - I'm all for the CIA, FBI, 
AFT, State, and local police doing 
their jobs* But now we've got a 
situation where self-appointed 
"jello sheriffs" are trying to 
institutionalise their intrusive 
behavior . 

For anyone unfamiliar with the 
term "jello sheriff, I'll digress 
a bit. These are the type of peo- 
ple you knew in grade school who 
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were appointed "monitor" when the 
teacher had to leave the room. 
They're the ones who put your name 
on the board with a check after 
it. Jello Sheriffs watch every- 
thing you do; and if they disap- 
prove of your behavior, they want 
to report it to a higher author- 
ity. He have one at our office who 
keeps track of how long anyone 
takes on a smoke break and keeps 
our supervisor apprised of anyone 
"taking advantage". 

One of the more virulent forms 
of the new police mentality that 
has gained national notoriety is 
this business of harassing preg- 
nant women. Two bartenders in Sea- 
ttle were ultimately fired because 
they refused to serve a drink to a 
pregnant woman and harassed her 
about pre-natal alcohol syndrome. 



•...#•?? smoke t 
many c^srarattas # 
ofr- -/nk -fcoo much 
Go-ffmm + e»At: too 

much sa ? fz and 
abso ?L#"fc«5» ly w# ? 7 
r*o-fc wear my seat: 
belt. So there.'" 



Another lady was forced out of a 
hot tub at her local spa. And the 
list goes on. This type of irra- 
tional "concern" makes me wonder 
about things. X find it so ironic. 
These same people will rail on and 
on about a woman's right to her 
own body and the right to kill an 
unborn in an abortion.. But 
noooo... we mustn't have a drink, 
or have a hot bath, or ride, or go 
bowling. 

Also in our state, there is a 
bill proposed in the legislature 
to limit the number of pets people 
may have to a quantity of 2. Now 
what constitutes a pet? Will our 
publisher Destafeno be limited to 
2 sheep on his ranch? What about 
cattle and horses? Who's going to 
tell 13 of my 15 cats they'll have 
to be put down because I'm over 
the limit? I also wonder when this 
will extend beyond the realm of 
pets . 

But you can see what's happen- 
ing. The jello sheriffs are having 
their way. These are the people 
that circulate petitions, and int- 
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roduce laws that infringe on indi- 
vidual liberties and drive the 
cost of goods and services to the 
ceiling. Warning labels are cover- 
ing product containers to the ex- 
tent that there's barely room for 
the brand name. The followers of 
the snoop mentality are attempting 
to create an employment opportuni- 
ty infrastructure for jello sher- 
iffs! 

"Well, what do you do for a liv- 
ing, sir?" 

"Oh, I count pets." 

OR 

"I'm on the preggers patrol." 

C'mon! Don't we have enough 
concerns in our own lives to keep 
us busy? Well if we didn't before, 
we do now. Beware of people and 
laws that wish to protect you from 
yourself. I'm going to have my own 
week of personal protest. All next 
week, I'll smoke too many ciga- 
rettes, drink too much coffee, eat 
too much salt and butter, and abs- 
olutely, will not wear my seat 
belt. So there! RC 



Reply to "Rex m 
SK*DOS And OS-9 

By Peter Stark 



(The following is the "mostly in- 
tact" letter written to "68xxx" in 
response to an article in the 
April '91 issue. I hope you will 
find it as I did; highly informa- 
tive on several levels, as well as 
directions. ED) 

Dear Jim, 

I enjoyed reading Ron 
Anderson's comparative review of 
SK*DOS, OS-9/68K, and REX; but I 
have several comments to make; in 
order from shortest to longest: 

1. SK*DOS for the 68000 is now 
priced at £70. But there is a spe- 
cial upgrade price of $50 to any- 
one who trades in any other 68K 

DOS. 

2. SK*DOS is currently available 
only from Star-K Software Systems 
Corp., P.O. Box 209, Mt. Kisco NY 
10549, and selected authorised 
licensees. It continues to operate 
properly on Peripheral Technology 
computers, but is no longer avail- 
able from them. (VGA is still not 
supported, ED) 

3. Ron forgot to mention many of 
the features which differentiate 
SK*DOS from some of the others. 
Por example, SK*DOS can handle any 
combination of floppy drives at 
the same time, 40- or 80-track, 
high or normal density. It can 
double-step to read 40-track disks 
in an 80-track drive (it can even 
boot from this combination). It 
can have two disk controllers at 
the same time. Individual drives 
can be software write-protected, 
which can prevent accidental 
writes to your hard drive. You can 
select any disk interleave by add- 
ing an argument to the format com- 
mand. And there is more. The point 
is that SK*DOS is designed to be 
flexible. 

4. Although I have for some time 
felt SK*DOS could be substantially 
speeded up by reading and writing 
an entire track at a time, several 
knowledgeable users have insisted 
the only way to get MS-DOS- like 



Murphy's Computer Dictionary 
o o o 

Hard drive: The 14th hole at 
the Torrey Pines golf 
course. 

Lisp: The only programming 
language named after a 
speech impediment. 

Obsolete: Any hardware or 
software more than three 
months old. 

Recursion: See Recursion. 

Sanskrit: Language in which 
most software documentation 
is written. 
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disk speed is to adopt the MS-DOS 
disk format. Now that Ron has poi- 
nted out whole-track operations do 
indeed speed things, I am making 
that change to SK*DOS. Incidental- 
ly, Ron's speed comparison between 
SK*DOS and other DOSes did not 
take into consideration that 
SK*DOS automatically verifies the 
disk after each write (unless you 
tell it not to), whereas other 
DOSes simply hope the disk was 
written OK, and do not check it. 
If verification had been turned 
off in SK*DOS, there would not 
have been nearly as much speed 
difference as he found. 

5. Finally, Ron says SK*D08 is 
"based on FLEX'* and is "a more 
grown up version of the FLEX style 
operating system than REX." I 
would like to make it clear that 
SK*DOS is VERY different from both 
FLEX and REX, both historically 
and internally. 

First, a bit of history. SK*DOS 
came about almost by accident. In 
the early 1980*8, I wrote a spel- 
ling checker called Hagic Spell 
for the SWTP 6800 computer. With 
versions initially for the Percom 
DOS, and then for 6800 Flex. The 



latter was translated to run with 
6809 Flex. A few months later, Don 
Williams (of the now discontinued) 
"68 Micro Journal" convinced me to 
buy a Radio Shack Color Computer 
and adapt Magic Spell to it. 

As soon as I got the CoCo, I 
realised it had no documented 
entry points for assembly language 
programs to tie into. In other 
words, I would have to write my 
own disk management routines to 
use it. This was not easy, since 
the CoCo's disk format was total- 
ly different from any DOS I had 
ever used before. 

To make the job as simple as 
possible, I decided to write the 
CoCo routines in such a way that 
Magic Spell (which was renamed 
Spell 'n Fix when I sold the Magic 
Spell name to Peachtree Software 

but that's another story...) 
could tie % into my disk routines 
with as few changes as possible. 
However, due to the many differen- 
ces everything had to be written 
from scratch. 

When I finished, I suddenly 
realised I had written a Disk Ope- 
rating System! Internally it was 
very different from both Percom 
DOS and Flex DOS, but the entry 
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points matched those of 6809 Flex 
because they had to - I wanted the 
same version of Magic Spell to run 
under both systems without changes 
(except for shortening text 
strings to fit the CoCo's narrower 
video screen). 

Since there was no DOS avail- 
able for the CoCo at that time, I 
put my disk routines into a sepa- 
rate package, and marketed them 
under the name STAR-DOS. Since 
STAR-DOS was designed to run Hagic 
Spell without changes, it could 
run other software that had been 
written for 6809 Flex too. People 
suddenly found they could run 
their old editors, assemblers, and 
other software on the CoCo. 
STAR-DOS eventually appeared in- 
side other CoCo products as well. 
Other CoCo software vendors lic- 
ensed it so they could make their 
Flex software run on the CoCo with 
minimal changes. 

But I immediately ran into pro- 
blems — some software would work 
with Flex, but not with STAR-DOS. 
In some cases there was not much 
to be done, since the problem was 
caused by the different disk for- 
mat. But in other cases I was very 
difficult to figure out what the 
problem was. Due the lack of debu- 
gging facilities for the CoCo I 
ported STAR-DOS back to my regular 
6809 system. 

The trouble with the CoCo disk 
format was it only supported sing- 
le-sided disks, only 35 tracks, 
and was very inefficient. I didn't 
want to implement that on my "big" 
6809 system; so I changed STAR-DOS 
to use the same disk format used 
by Flex. 

And so, over the space of a 
year or so, STAR-DOS gradually 
grew to the point where, while its 
insides were totally different 
from Flex, it (a) used the same 
disk format, and (b) the interface 
to application programs (such as 
Magic Spell) matched Flex's to 
the degree that these programs 
could run with STAR-DOS (which was 
renamed to SK*DOS right about 
then.) 

This was all very nice, but 
some of the application programs 
STILL didn't work with SK*DOS. 
Every few weeks, someone would 
send me a program with a comment 
like "it runs with Flex, why the 
h--l doesn't it run with SK*DOS??" 
Hell, of course the problem was 
that SK*DOS didn't work like Flex. 



It was different for two rea- 
sons - first, because it just sort 
of grew into place over several 
years. The more important second 
reason was - at this point, SK*DOS 
ran on exactly the same hardware 
as Flex, and was therefore a di- 
rect competitor for Flex, which 
was still marketed by TSC. I knew 
that if there was any slightest 
similarity with Flex, TSC's law- 
yers could have a ball! 

I was careful to write STAR-DOS 
/ SK*DOS under "clean- room" condi- 
tions, similar to how Phoenix 
wrote the first IBM-compatible 
BIOS for IBM clones. I made sure 
to stay away from anything and 
anyone who might have any source 
code or other confidential or un- 
published information about Flex, 
and made sure never to look at any 
Flex code itself. Instead, SK*DOS 
was written from scratch, but in 
such a way that it would do the 
same things that magazine arti- 
cles, other authors, or user's 
manuals claimed that Flex did. (I 
know that a number of people have 
carefully examined the innards of 
SK*DOS to look for similarities to 
Flex; I am quite sure that neither 
TSC nor anyone else ever found 
any . ) 

The real problem with applica- 
tion programs that didn't work was 
some of the people who wrote knew 
more about Flex than I did! They 
would use things in Flex which 
were not documented anywhere or 
generally known, or rely on things 
which Flex did for its own bene- 
fit, things which SK*DOS either 
did differently, or did not do at 
all. In some cases, they even 
seemed to take advantage of things 
that looked to me like Flex mis- 
takes. The hard part was discover- 
ing what was going on without loo- 
king at Flex code, so I could mod- 
ify SK*DOS to keep these applica- 
tion programs happy. 

I eventually developed a work- 
able technique. When someone sent 
me a program which did not work 
correctly under SK*DOS, I would 
run it simultaneously on two sys- 
tems, one running Flex, the other 
running SK*DOS. I wrote a trace 
program which would send out the 
results of every step (except for 
steps inside the DOS, which were 
obviously different), and a third 
computer which compared these re- 
sults, looking for differences. It 
might sometimes take hours before 
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this third computer would signal a 
difference, f^t which point I'd 
have to decide whether it was sig- 
nificant. If so, then I had to 
make a change to SK*DOS to give 
the errant program the same inputs 
as it was getting from Flex, and 
then run the whole thing again. 

It took almost two years to get 
6809 SK*DOS to the point where 
everything would run on it. In the 
process, I had to add some totally 
useless, and sometimes even wrong 
things to SK*DOS just to fool 
other programs so they would work 
the same way as they did with 
Flex. 

The end of the story - SK*DOS , s 
adaptation to the 68000 seems 
almost anticlimactic. Now that I 
was no longer limited to squeezing 
everything into 8K of memory, it 
became possible to extend and im- 
prove SR*DOS beyond its 6809 
roots, adding things for which 
there was never room before. 

When I look at it in retro- 
spect, I see the development of 
6809 SK*DOS, and ultimately 68000 
SK*DOS, could have been done in 
two different ways. The easy way 
would have been to just wait until 
Flex was no longer supported. When 
the original manufacturer no lon- 
ger cared, I could then simply 
copy it. This could have given us 
a Flex-like 68000 operating system 
with a minimum of fuss and effort. 

But SK*DOS was developed the 
hard way, the honest way, knowing 
that at any time the manufacturer 
of Flex, or any one of his licen- 
sees, could pounce on me if there 
was even a hint of copying. Any 
operational similarities to Flex 
are there not because it was .con- 
venient to copy them, but because 
they were absolutely necessary to 
allow other people's software to 
work with it. 

This is why I want to stress 
that SK*DOS is NOT "based on 
Flex." It also explains why SK*DOS 
source code is not available for 
distribution, and why it has not 
been placed in the public domain. 
SK*DOS is an original product, 
100% legally protected with copy- 
rights and a registered trademark, 
and a potentially valuable proper- 
ty, worth protecting. 
PS 
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